/*
 * Copyright [2022] [https://www.xiaonuo.vip]
 *
 * Snowy采用APACHE LICENSE 2.0开源协议，您在使用过程中，需要注意以下几点：
 *
 * 1.请不要删除和修改根目录下的LICENSE文件。
 * 2.请不要删除和修改Snowy源码头部的版权声明。
 * 3.本项目代码可免费商业使用，商业使用请保留源码和相关描述文件的项目出处，作者声明等。
 * 4.分发源码时候，请注明软件出处 https://www.xiaonuo.vip
 * 5.不可二次分发开源参与同类竞品，如有想法可联系团队xiaonuobase@qq.com商议合作。
 * 6.若您的项目无法满足以上几点，需要更多功能代码，获取Snowy商业授权许可，请在官网购买授权，地址为 https://www.xiaonuo.vip
 */
package com.xieq.dota.modular.group.service;

import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.baomidou.mybatisplus.extension.service.IService;
import com.xieq.dota.modular.group.param.GroupEditParam;
import com.xieq.dota.modular.match.param.*;
import com.xieq.dota.modular.match.result.GroupDrawResult;
import com.xieq.dota.modular.matchplayer.entity.MatchPlayer;
import jakarta.validation.Valid;
import com.xieq.dota.modular.group.entity.Group;
import com.xieq.dota.modular.group.param.GroupAddParam;
import com.xieq.dota.modular.group.param.GroupIdParam;
import com.xieq.dota.modular.group.param.GroupPageParam;

import java.util.List;

/**
 * 分组表Service接口
 *
 * @author xieq
 * @date  2025/11/10 09:51
 **/
public interface GroupService extends IService<Group> {

    /**
     * 获取分组表分页
     *
     * @author xieq
     * @date  2025/11/10 09:51
     */
    Page<Group> page(GroupPageParam groupPageParam);

    /**
     * 添加分组表
     *
     * @author xieq
     * @date  2025/11/10 09:51
     */
    void add(GroupAddParam groupAddParam);

    /**
     * 编辑分组表
     *
     * @author xieq
     * @date  2025/11/10 09:51
     */
    void edit(GroupEditParam groupEditParam);

    /**
     * 删除分组表
     *
     * @author xieq
     * @date  2025/11/10 09:51
     */
    void delete(List<GroupIdParam> groupIdParamList);

    /**
     * 获取分组表详情
     *
     * @author xieq
     * @date  2025/11/10 09:51
     */
    List<MatchGroupDetail> detail(String matchId);


    /**
     * 抽取选手
     *
     * @param param 参数
     * @return 选手列表
     */
    List<GroupDrawResult> drawPlayers(GroupDrawParam param);

    /**
     * 获取可选队长列表
     *
     * @param param 参数
     * @return 队长列表
     */
    List<GroupCaptainResult> captainList(GroupCaptainParam param);

     /**
     * 设置队长
     *
     * @param param 参数
     */
    Boolean update(@Valid GroupAddPlayerParam param);

     /**
     * 卡池剩余选手列表
     *
     * @param param 参数
     * @return 选手列表
     */
    List<GroupDrawResult> cardRemainPlayer(@Valid GroupDrawParam param);

}
